METHOD AND SYSTEM FOR OBTAINING PERFORMANCE DATA FROM 
SOFTWARE COMPILED WITH OR WITHOUT TRACE HOOKS 



FIELD OF THE INVENTION 

[0001] The present invention relates generally to software performance analysis. 
More particularly, the present invention relates to a method of obtaining performance data 
from software compiled with or without trace hooks. 

BACKGROUND OF THE INVENTION 

[0002] Computer software is created by writing source code files in programming 
languages. Source files typically consist of functions or routines that perform some 
operation. These source code files consist of human-readable text which are translated by 
compilers into a machine-readable form known as object code. The object code from one 
or more source code files are put together by a linker to form a load module. These 
modules are loaded into a computer system where they can be executed. Each object 
contains instructions which the computer system executes. Each instruction requires time 
to execute. 

[0003] Software performance analysis tools are typically used by software 
developers to gain an understanding of time of execution and path of execution of 
software. The performance analysis tool is run against specific software and performance 
data is produced. The performance data is then presented to a developer, commonly in a 
graphical format. The developer, using the data, can locate places in the software where 
inordinate amounts of execution time are being used. The developer can then modify the 
source code to improve the efficiency of the software. These software performance 
analysis tools are also helpful in gaining an understanding of the path of execution of 
software. This can be especially useful if the developer does not have prior familiarity 
with the software. 
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SUMMARY OF THE INVENTION 

[0004] An exemplary embodiment of the present invention is a method for 
obtaining performance data from software compiled with or without trace hooks. The 
method begins with a software application being entered and a trace data flag being set to 
off. Then, for each module initiated by the software application several steps are 
performed. First, the trace data flag is set to on if the module is registered with a 
performance analyzer tool. Next, it is determined whether the module being initiated 
contains trace data hooks. If the module does have trace data hooks and the trace data flag 
is on, then a request is transmitted to the performance analyzer tool to record trace data in 
response to encountering the embedded trace data hooks in the module. If the module 
does not have trace data hooks and the trace flag is on a request is transmitted to the 
performance analyzer tool to record trace data in response to entering and exiting the 
module. When the software application has exited, a report based on the trace data is 
received from the performance analyzer tool. Additional embodiments include a system 
and storage medium for obtaining performance data from software compiled with or 
without trace hooks. 

BRIEF DESCRIPTION OF THE DRAWINGS 

[0005] FIG. 1 is a flowchart of an exemplary method for obtaining performance 
data from software compiled with or without trace hooks. 

[0006] FIG. 2 is diagram showing an exemplary flow of control between two 
modules in an application using the present invention. 

DETAILED DESCRIPTION OF THE INVENTION 

[0007] The present invention allows for software developers to record performance 
data for modules, mutually exclusively, via one of two methods. In an exemplary 
embodiment, the recording of performance data is initiated by either intelligence in the 
operating system services or by trace information hooks compiled into the software to be 
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analyzed. Using the first method, recording performance data using intelligence in the 
operating system, results in the creation of coarse grained performance data representing 
execution to a load module level. An application consists of load modules which can be a 
single object or a collection of objects. In an exemplary embodiment, as software modules 
and objects are being analyzed, this coarse grained method is used to record trace data 
unless the object is compiled with hooks, in which case the second method is used to 
create fine grained performance data. In an exemplary embodiment, the operating system 
running the application has been modified to check for the presence of hooks in modules 
upon module entry and exit. The second method, the use of trace information hooks, 
creates finer grained performance data representing execution to a function level. One 
kind of hook is a program entry or exit hook and it results in trace data being generated 
every time a module is entered or exited. Basic information logged by the performance 
analysis tool could include the time and module name. Another type of hook is a function 
entry or exit hook which results in data being logged when the particular function is 
entered or exited. Typically data logged by the performance analysis tool would include 
the function name, the module name and the time. 

[0008] The present invention can be used with any compiler that supports inserting 
compatible hooks into compiled source code. Examples of such compilers are the IBM 
OS/390 C and C++ compilers. In an exemplary embodiment the present invention is used 
with application modules written in C, C++, or assembler. In an exemplary embodiment, 
the present invention invokes a commercially available performance analyzer tool that is 
called to log particular performance analysis events. This performance analyzer tool can 
record performance data in a log. In addition, when requested or when an application 
completes, the performance analyzer can consolidate the log data and create a formatted 
report containing the data. An example of a performance analysis tool is the TPF 
Performance Analyzer for Visual Age Client, available from IBM. 

[0009] FIG. 1 depicts an exemplary method for obtaining performance data from 
software compiled with or without trace hooks. First, in step 102, the user registers with 
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the performance analyzer tool which module they would like to have start the performance 
analysis tool. The process of registering with the performance analyzer tool enables 
tracing capabilities in the operating system services. When the application executes and 
the module registered is entered, the performance analyzer tool begins tracing. Tracing of 
the registered module and any modules following the registered module continues until the 
application terminates. Referring to FIG. 1, at step 104 the application is entered. At step 
106 a check is made to see if the module about to be executed is registered with the 
performance analyzer tool. If the module is registered then step 108 is performed to see if 
the performance analyzer is already running. If the performance analyzer is not already 
running, it is initialized at step 110. 

[0010] At step 1 12, a check is made to see if the module about to be entered 
contains hooks. The existence of hooks is determined by the operating system service 
which is called when a new module is being entered. If the module does not have hooks, 
step 1 13 is performed to see if the performance analyzer tool is running, which means that 
the current module or a previous module has been registered and that this module should 
collect program entry trace data. If the performance analyzer tool is running then step 1 14 
is performed and the performance analyzer tool is called to log a program entry event. The 
module is entered at step 116 and the application runs until one of three events occur. If, 
as shown at step 1 18, a hook event occurs then step 1 19 is performed to see if the 
performance analyzer tool is running. If the performance tool is running, this means that 
the current module or a previous module has been registered and that this module should 
collect embedded program hook data. If the performance analyzer tool is running then 
step 120 is performed. At step 120, the performance analyzer tool is called to log trace 
information based on the hook contained in the instruction. Hooks may include program 
entry, program exit, function entry and function exit hooks. 

[001 1] Next, step 122 is performed to determine if a module call or module return 
event occurred. This determination is made by the operating system service which is 
called when a new module is being entered. If the module being exited does not contain 
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hooks, then step 126 is performed to see if the performance analyzer tool is running, which 
means that a the current module or a previous module has been registered with the 
performance analysis tool and that the current module should collect program exit or entry 
data. If the performance analyzer tool is running then step 128 is performed to call the 
performance analyzer tool, sending it a program entry or exit event. If at step 124 it was 
determined that the module being entered or exited does contain hooks then step 106 is 
performed for the next module being entered. 

[0012] At step 130 a check is made to see if a terminate event has occurred. If a 
terminate event has occurred, then a check is made at step 131 to see if the performance 
analyzer tool is running. If the performance analyzer tool is running then step 132 is 
performed. At step 132 the performance analyzer tool is called and sent a module exit 
event. Next, at step 134, the performance analyzer tool is terminated and the gathered 
trace information is formatted. Then step 136 is performed and the application is 
terminated. If the analyzer tool was not running, as determined at step 131, then step 136 
is performed to terminate the application. 

[0013] In an exemplary embodiment, the operating system running the application 
being analyzed has been modified to check for the presence of hooks in modules upon 
module entry and exit. If hooks are not found, the operating system passes control to the 
performance analyzer tool with a request to log either program entry or program exit event 
data. In an exemplary embodiment, as modules are entered and exited, control of 
execution is passed from the module being exited to the operating system, then control is 
passed to the module being entered. As control is passed from the module being exited, 
operating system services detect whether the module being exited has been compiled with 
hooks. If not, the operating system service generates a call to the performance analyzer 
tool to record trace information. If the module being exited is compiled with hooks, the 
operating system service does nothing because the hook in the object code will initiate 
recording of trace information. Hooks in the object code will initiate the recording of 
trace information for each function call in the module. The same process described above 
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is performed for modules being entered. The intelligence in the operating system creates 
the capability to record the amount of time spent in the system services. This data may be 
used to decide what objects go into what load modules in order to create more efficient 
packaging of applications. 

[0014] FIG. 2 is diagram showing an exemplary flow of control between two 
modules in an application using the present invention. The application begins and 
terminates in module one 202 which is registered with the performance analyzer tool. 
Module one 202 is compiled with hooks, two hooks are shown for example purposes and 
more hooks may be contained in module one 202. In addition, the two hooks shown are 
examples of what a hook could look like, the actual format of the hook will vary based on 
a specific implementation. Module two 206 does not contain hooks. Points A 210, B 212, 
C 216, and D 214 are operating system services which execute when exiting and entering 
the modules 202 206. During execution module one 202 would come to the sample code 
204. Code 204 in module one 202 contains a hook "Ex call_before" which calls the 
performance analyzer to record trace data. Next, the code 204 calls module two 206 "call 
module two." When this instruction is encountered, the operating system service, at point 
A 210, looks for hooks in module one 202 to determine if it should initiate recording of 
trace information by calling the performance analyzer tool. In this example, the module 
being exited, module one 202, contains hooks so the operating system service does 
nothing. Next, at point B 212, the operating system service looks in module two 206 to 
determine if it should initiate the recording of trace information by calling the performance 
analyzer tool. In this example, module two 206 does not have hooks so the operating 
system service will initiate the recording of trace information. The operating system 
service will call the performance analyzer tool to log a program entry event. 

[0015] Control is then passed to module two 206 which then executes. When the 
return to module one 202 instruction is encountered ( "return to module one" 208) the 
operating system service is called at point C 216. Point C 216 looks in module two to 
determine if the recording of trace information is necessary. Because module two 206 
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does not contain hooks, the operating system service calls the performance analyzer tool to 
log a program exit event. Similarly, at point D 214 the operating system service looks in 
module one 202 to determine if the recording of trace data is required. Here, because 
module one contains hooks, the operating system service will not call the performance 
analyzer tool. In this example "call module two" 204 and "return to module one" 208 are 
examples of sample calls to system services which cause a new module to be entered. 
These calls initiate the operating system services described above. 

[0016] An advantage of the present invention is that a user can choose the 
granularity of the trace data by compiling in trace hooks or by leaving the trace hooks out. 
Fine granularity can be applied to modules of particular interest. The ability to select some 
modules in an application for fine grain analysis, other modules in the same application for 
coarse grain analysis, and still other modules in the same application to have no 
performance analysis, provides a great deal of flexibility in the performance analysis 
process. It helps to avoid the generation of too much information by allowing a user to 
specify exactly what level of detail to generate for each module within an application. 

[0017] As described above, the present invention can be embodied in the form of 
computer-implemented processes and apparatuses for practicing those processes. The 
present invention can also be embodied in the form of computer program code containing 
instructions embodied in tangible media, such as floppy diskettes, CD-ROMs, hard drives, 
or any other computer-readable medium, wherein, when the computer program code is 
loaded into and executed by a computer, the computer becomes an apparatus for practicing 
the invention. The present invention can also be embodied in the form of computer 
program code, for example, whether stored in a storage medium, loaded into and/or 
executed by a computer or transmitted over some transmission medium, such as over 
electrical wiring or cabling, through fiber optics, or via electromagnetic radiation, wherein, 
when the computer program code is loaded into and executed by a computer, the computer 
becomes an apparatus for practicing the invention. When implemented on a general- 
purpose microprocessor, the computer program code segments configure the 
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microprocessor to create specific logic circuits. 

[0018] While the invention has been described with reference to exemplary 
embodiments, it will be understood by those skilled in the art that various changes may be 
made and equivalents may be substituted for elements thereof without departing from the 
scope of the invention. In addition, many modifications may be made to adapt a particular 
situation to the teachings of the invention without departing from the essential scope 
thereof. Therefore, it is intended that the invention not be limited to the particular 
embodiments for carrying out this invention, but that the invention will include all 
embodiments falling within the scope of the appended claims. 
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